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GENERAL SUMMARY 


FILE COPY is a utility program which copies files from. one 
device to another. It requires at least a 6K partition 
with either 


1. a card reader (device 0); 
OR 
2. a workstation (device 0) and a card reader (device 


1)*. 


Input files may consist of either fixed-length or variable- 
length records, blocked or unblocked, and may come from any 
of the following devices: 


@ card reader 
e magnetic tape drive 
e disc drive (either a physical sequential or a DMF 


linked sequential file) 
e workstation 


e high speed paper tape reader (8 channel, ANSI 
format) 


Output files may consist of either fixed-length or 
Variable-length records, blocked or unblocked, and may be 
routed to any of the following devices: 


e line printer 
e card punch 
e magnetic tape drive 
e disc drive (pnvetent sequential file) 
e workstation 
e paper tape punch 
* This assumes’ standard device numbers. However, 


provided that the user alters the appropriate 
parameters, there is nothing to prevent the card reader 
from having a device number 2-9. 
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GENERAL SUMMARY 


The user may enter the necessary parameters either through 
the card reader or the workstation. If the output device 
is specified as being something other than a line printer, 
then the user may request that an auxiliary listing be 
produced. A sample of FILE COPY formatted printed output 
is shown in Appendix A. 


FILE COPY does not test the parameters to make sure they 


are within the valid range. Consequently, erroneous 
parameters may produce unexpected results. 


The error messages resulting from I/O errors are shown in 
Appendix B. 


A few typical uses of FILE COPY are as follows: 


@ Print a file (from magnetic tape, disc, paper tape, 
or punched cards). 


e Create a magnetic tape file from cards. 


e Copy of magnetic tape, and in the process alter the 
blocking factor. 
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DEFINING FILES 


To define an input file, the user must always provide’ the 
following parameters: 


e Input Device Type (physical sequential disc, DMF 
linked sequential disc, magnetic tape, or other) 


8 Record Format (fixed-length or variable-length) 
e Record Size (maximum size for variable-length 
records) 

e Blocking Factor 

e Number of Blocks to be Processed 
If the input device is disc, the user must provide’ the 
starting disc address of the file. If the input device is 
anything other than a disc, the user must provide the 


device's number. 


To define an output file, the user must always provide the 
following parameters: 


e Output Device Type (physical sequential disc, 
magnetic tape, line printer, or other) 


e Record format (fixed-length or variable-length) 


e Record Size (maximum size _ for variable-length 
records) 
e Blocking Factor 


If the file is destined for disc, the user must provide the 
starting disc address. If the file is destined for any 
device other than a disc, the user must provide the 
device's number. 
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FILE PARAMETER CARDS (FP CARDS) 


An FP card contains 
Single file from 
input file, defines 
or not an auxiliary 


All the parameters 


follows: 


1 


6 


0 


7 


010 


819 


1 


12 


FIP|D} j0 
rfal3|ats 


Device 4 


VF 
10} 11 


Device Number 
Record Size 
Blocking Factor 


Record Format 


Number of Blocks to be Processed 


INPUT PARAMETERS 


2 


13 


Starting Disc iil 


all the parameters 
one device to another. 


needed to copy a 
It defines the 


the output file, and specifies whether 
listing is desired. 
are positional. The format is as 


28 


0 


l 


3 


4 


4 


15 


J 


16 


1 


19 


9 


20 


0 


21 


vil 


1 


27 


6/0 
17118 


O|F 
31132)33 


{ 


6 2 34}35135|36|/3 7/3889 1 ? 


Auxiliary Listing Device Number 


OUTPUT PARAMETERS 


FP cards may be either read in through the card reader, or 
typed in through the workstation. 


The valid range 
following page. It 


for each parameter is 


shown on the 


should be remembered that FILE COPY 


does not test parameters to see if they fall within their 
respective valid ranges. 


FILE COPY UTILITY PROGRAM 


Title for Printed Output 
Starting Disc Address 
Record Format 


Blocking Factor 


Device Number 


Device Type 


Record Size 
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FILE PARAMETER CARDS (FP CARDS) 


Device Type (input): 


D (disc) 
T (magnetic tape) 
O (other) 


Device Type (output): 


(physical sequential disc) 
(magnetic tape) 

(line printer) 

(other) 


OuvwH DU 


Device Number (input or output): 


L (if linked sequential disc -- input only) 
0-9 


Record Size (input or output): 
0001-9999 


Blocking Factor (input or output): 
01-99 


Record Format (input or output): 


F (fixed-length records) 
V (variable-length records) 


Starting Disc Address (input or output): 
000000-999999 


Number of Blocks to be Processed: 


00001-99999 


Auxiliary Listing Device Number: 
0-9 
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USING FILE COPY 


WORKSTATION AS DEVICE 0, CARD READER AS DEVICE | 


The user places the absolute loader and FILE COPY in the 
card reader's input hopper. If the FP cards are to be read 
in through the card reader, then they should be placed in 
the hopper behind FILE COPY. The FP cards, if present, 
should be followed by a unit separator card. The user then 
initiates a load sequence at the workstation, places the 
workstation on-line, and enters the following instruction: 


1001010290 


This "bootstraps" the loader into memory. The loader then 
brings FILE COPY into memory and passes control to it. 
FILE COPY responds by typing the following message on the 
workstation: 


FP INPUT IOC NO = X 


This asks for the number of the device through which the FP 
cards are to be read. 


If the user responds by typing a 0, then FILE COPY types 
ENTER FILE COPY PARAMETERS and waits for the user to enter 
80 characters (i.e., a single FP card). If a particular FP 
card does not require the full 80 characters, then the user 
May prematurely terminate the entry by depressing the ENTER 
key. When the user has entered an FP card, FILE COPY 
performs the defined operation. When the defined operation 
is finished, FILE COPY responds with FP INPUT IOC NO = X. 
This cycle is repeated until the user finally depresses the 
ENTER key without having typed any parameters. 


If the user responds by typing a 1, then FILE COPY reads 
the first FP card and performs the defined operation. When 
the operation is finished, FILE COPY responds with FP INPUT 
IOC NO = kX. This cycle is repeated until the unit 
separator card is encountered. 


NOTE: If an FP card calls for input through the _ card 
reader, then the input file terminated by a unit separator 
card must be placed immediately behind the particular FP 
card. | 
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USING FILE COPY 


CARD READER AS DEVICE 0 


The user places a "bootstrap" card (0001010290 in columns 
1-10), the absolute loader, FILE COPY, the FP cards, and a 
unit separator card in the card reader's input hopper. He 
then initiates a load sequence at the card reader. This 
"bootstraps" the loader into memory. The loader brings in 
FILE COPY which then reads the first FP card and performs 
the defined operation, reads the second FP card and 
performs the defined operation, etc., until the unit 
separator card is encountered. | 


NOTE: If an FP card calls for input through the _ card 
reader, then the input file terminated by a unit separator 
card must be placed immediately behind the particular FP 
card. 
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SPECIAL CONSIDERATIONS 


1. FILE COPY uses the locations above 5000P for its input 
and output buffers. This means, for example, that in 
a 10K partition the maximum sized input block plus’ the 
maximum sized output block may not exceed 5000 
characters. 


2. When it is desired to obtain formatted printed output 
Via the workstation, one must either specify the output 
device type as P (line printer) with an IOC device 
assignment of zero, or specify device zero as_ the 
auxiliary listing device. 


If it is desired to display a single record on the 
workstation without the usual formatting, one must 
specify the output device as O (the letter O) with an 
IOC device assignment of zero. 


3. Variable-length blocks and records must conform to’. the 
following conventions: 


Each block must have as its first four characters 
a block length indicator (BLI). The BLI includes 
itself in the length specification. 


Each record must contain as its first four 
characters a record length indicator (RLI). The 
RLI includes itself in the length specification. 


On disc, each BLI must reside in the first four 
positions of a sector. 


4, Fixed-length records cannot be created from variable- 
length records because the RLI is copied as part of the 
data. 


When creating variable-length records from fixed-length 
records, FILE COPY automatically creates the proper 
RLIs and BLIs. 


5. Inter-partition file contention is not tested for. 


6. FILE COPY expects linked sequential disc files to be 
terminated by six slashes in sector positions 95-100 of 
the final sector of the file. Similarly, it expects 
physical sequential disc files to be terminated by a 
sector containing the characters *END in_ sector 
positions 1-4. 


On output, FILE COPY does not automatically generate 
the *END. The *END must be in the file being copied as 
the first four characters of a separate block (the 
block must not contain a BLI or RLI). 
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SPECIAL CONSIDERATIONS 


7. If the user wishes to process all blocks in the input 
file, he specifies so by using 99999 as the number of 
blocks to be processed. 


8. Once file copying has been begun, the _ user may 
prematurely terminate the operation by depressing the 
SERVICE REQUEST switch on the workstation. The 
Operation will terminate after the current record has 
been copied. 


9. To use a linked sequential disc file as input reguires 
that the user know the actual starting disc address of 
the file (i.e., the user cannot specify pool name _ and 
file name). 
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APPENDIX A 


SAMPLE OF FILE COPY FORMATTED PRINTED OUTPUT 


The first page contains the list of parameters which the 
user supplied. They appear exactly as entered on the FP 
card. The main body of the printed output looks as follows 
(this example contains a series of 80 character records, 7 
to each block): 


(User-supplted tittle) 


SAMPLE OF FILE COPY PRINTED OUTPUT SYSTEM TEN - FILE COPY RECORD LISTING 
Ves Det Owe Sree 20 sear 0s ed dares Oc AOnre cB iawd0ee lOc O0 cae Os wel Ove se O<6480i Ova IO. eee See 100 
BLOCK ] AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARAAAAAAAAAAAAAAAAAAAAAABAA RECORD ] 
BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB RECORD 2 
CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC RECORD 3 
DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD DDDDDD DD DDDDDD DDDDDD DD DDDDDD DDDDDDDDDDDDDD DD RECORD 4 
EFEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEFEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE RECORD 5 
Mdddddddddddddddaadddddddddddddddddddaddaaaadaiaadadiaadddaaaaaaadaaadadiaiaiail RECORD 6 
GGGGGGGGGGG GGG GGGGG6 GGGGGGG.G66 GG GGGGGGGGGGGGGG.GGGGG6 GGGGG GGGGGGGGGGGGGGGGGGGGG66 RECORD 7 
BLOCK 2 HHHHHRHHHHHHHHHHHHHHHHHHHHHH HHHHHHKHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHH RECORD 8 
TITQIQITIQITILILITILIIEIITITIQIIILILIIQIIIITILILIIQIIIITQIIIIIQIIIIIIIIIIIIIIIIT RECORD 9 
UNIUIOIIVULOCU re TOrUrecerUrvrecerU rece rUsU ecu Ure rerUCOcORUOLUUrOCULOLOC LU CUrUre ery UCM LULU LULU CULO LUULOCUUU LO LUCO LOO LULO OULU OSU FO UCU LOY 8 RECORD 10 
KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK RECORD 1] 
LLLLLLLLLLLLLLLLLLLELLELLLLLLLLLELLLLLLLLLLLLLELELLLLLLLLLELELLLELLLLELLLLLLELLLLLLL RECORD 12 
MMMMMMMMMMMMMMMMMMMMMMMMM MMM MM MM MM MM MM MMMMMM MMMMMMMM MM MMMMMMMMMMMM MMMM MMMM MM MMMM RECORD 13 
NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN RECORD 14 
BLOCK 3 00000000000000000000000000000000000000000000000000000000000000000000000000000000 RECORD 15 
PPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPPP RECORD 16 
0AQQQQQIQQIIAIIAIA|IAAIIANIAIAINAAAIIAIIAIAIAARIAI|IAIRIAIIAIIAIIAAAIIAIIIY RECORD = 17 
RRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRRR RECORD 18 
SSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSSS RECORD 19 
TETTTTTTTTT TTT TTT TT TTT TTT TTT TTT TTT TTT TTT TTT TTT TTT TTT TTT TT TTT TTT TTT ttt ttt Trt rot RECORD 20 
UJ UU UU UUUU UU UU UU UU UU UU UUVUUU UU UU UU UU WU UU UU UU UU UU UU UU UU UU UU UU UU UU UU UU UU UU RECORD 2] 
BLOCK 4 VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV RECORD 22 
WWI WW WL BL WT Yd Yd Ef Taf td WK LK TTT TPL ka a La YS aT La TT LJ dW TK TTT dW RECORD 23 
XXXXXXAXAXXAXX XXX XXXXAXXAXAX XXXXXX XX XX AX XXX XAXAXXXXXXXXXAX AX AXXX AX AX XX XX XX XX XXX X RECORD 24 
YYYYYYVYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYVYYYYYYYYYYYYVYYYYYVYYYVYYYYYYYYYYYYY RECORD 25 
2222222222222 2222222222222 2222222222222 2222222222222 22222222 2222222222222 722772 RECORD 26 
ABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABABAB RECORD 27 
BCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBCBC RECORD 28 
BLOCK 5 CDCDCDCDCDCDCDCDC DCDCDC DCDCDCDCDCDCDCDCDCDCDCDCDCDCDCDCDCDCDC DC DCDCDCDCDCDCDCDCD RECORD 29 
DEDEDE DE DE DE DE DE DE DE DEDE DE DE DE DE DE DE DE DE DE DE DE DEDEDE DE DE DE DEDEDEDEDE DE DE DE DEDEDE RECORD 30 
EFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEFEF RECORD 31 
FGF GFGFGF GF GFGFGFGFGFGFGF GFGF GFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFGFG RECORD 32 
GHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHGHG HG HGHGHG HG HGHGHGHGHGHGHGH RECORD 33 
HIHTHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHTIHIHTHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHIHI RECORD 34 
EUR LUE CUD CUR EVD PURE DCUR CUCU RUE CUD CUP CUR CUR CUD CUD CUREUDCUDKUD CUR CUD UR GUD KOR CUR CUD CUR EURCUDEUDCUDCURCUD CUP CUR CUD CY, RECORD 35 
The user-supplied title appears at the top of every page. 
If the output device was specified as being a line printer, 
then the block and record counts within the main body of 
the listing reflect the input blocking factor. In an 
auxiliary listing, they reflect the output blocking factor. 
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APPENDIX A 


The final line contains the following totals: 
BLOCKS READ xxxx RECORDS READ xxxx WRT SKIPS xXxxxxx 


The first two statistics always reflect the input blocking 
factor. It should be noted that in an auxiliary listing 
they will differ from those which appear in the main body 
if the blocking factor is being altered from input to 


output. The third statistic refers to the number of 
sections of blank tape which had to be produced due _ to 
persistent parity errors. If, after four attempts, FILE 


COPY cannot successfully write a block on magnetic tape, it 
erases a section of tape and then tries to write the block, 
etc. WRT SKIPS tells the number of times this’ situation 
occurred. 


If an I/O error occurred, then the related message (see 
Appendix B) also appears in the printed output. 
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APPENDIX B 


I/O ERROR MESSAGES 


A CONDITION CODE OF 1 WAS RETURNED WHEN READING 
FROM THE INPUT DEVICE. 


A CONDITION CODE OF 3 WAS RETURNED WHEN READING 
FROM THE INPUT DEVICE. 


A CONDITION CODE OF 4 WAS RETURNED WHEN READING 
FROM THE INPUT DEVICE. . 
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DETACH HERE 


FILE COPY UTILITY PROGRAM REFERENCE MANUAL 
Publication No. 40-239 


We produce manuals for you, and we want you to find them useful and informative. That’s our job. 
So we’re asking you to help us furnish you with the best possible publications. Please take a few minutes to 


answer the following questions. Add any comments you wish. If you desire a reply to any question, be sure to 
include your name and address. 


Thank you. 


e Does this manual meet your needs? Yes L] No LJ 
If not, what additional information would be of help to you? 


e Can you find what you're looking for quickly and easily? Yes L_] No LJ 
How can the organization be improved? 


e Is the material easy to read and to understand? Yes L] No L] 
Are there enough illustrations to support the text? Yes L] No L] 
Comments 

e Did you find any errors or ambiguities in the manual? Yes L] No LJ 


If yes, please cite page, line, and/or figure number with your comments. 


e Other comments. 


@ What is your relationship to the product described? 
[} Operator. 
LJ Programmer. 
LJ Other (please specify) 


SINGER 


FRIDEN DIVISION 


JIArLG oO LFAPrLE 


FOLD BACK 


FIRST CLASS 


PERMIT No. 320 


San Leandro, Calif. 


BUSINESS REPLY MAIL 
No postage stamp necessary if mailed in the United States 


POSTAGE WILL BE PAID BY 


FRIDEN DIVISION 

THE SINGER COMPANY 
2350 Washington Ave. 

San Leandro, California 94577 


Attn: Customer Technical Publications, 
Department 753 


FOLD BACK 


